.\"Copyright 1995 Adam Migus (amigus@cs.mun.ca)
.TH RUP 1 "Sept 25, 1995" "Linux 1.2" "Linux Programmer's Manuel"
.SH NAME
rup \- remote uptime display
.SH SYNOPSIS
\fBrup\fP { -u | -v | \fIhosts\fP ... }
.SH DESCRIPTION
\fBrup\fP displays a summary of the current status of a  particular 
host or all hosts on the local network.
.br
The output shows how long the system has been up, the number of
users currently on the system (if the system is running the current
version of \fBrpc.rstatd(8)\fP), and the load  averages.
.br
The load average numbers give the number of jobs in the run queue 
averaged over 1, 5 and 15 minutes. 
.br
The \fBrpc.rstatd(8)\fP daemon must be running on the remote host 
for this command to work.
.br
\fBrup\fP uses an RPC protocol defined in /usr/include/rpcsvc/rstat.x
.SH "COMMAND LINE OPTIONS" 
.TP
\fB-v\fP
prints the current version of rup and exits
.TP
\fB-u\fP  
broadcasts for infornmation from machines capable of returning 
users information implemented in the newest version of rpc.rstatd
.SH DIAGNOSTICS
.TP
rup: RPC: Program not registered
The \fBrpc.rstatd(8)\fP daemon has not been started on the remote host.
.TP
rup: RPC: Timed out
A communication error occurred.  Either the network is excessively 
congested, or the \fBrpc.rstatd(8)\fP daemon has terminated on the 
remote host.
.TP
rup: RPC: Port mapper failure - RPC: Timed out
The remote host is not running the portmapper (see \fBrpc.rstatd(8)\fP)
and cannot accomodate any RPC-based services.  The host may be down.
.SH SEE ALSO
\fBportmap(8)\fP, \fBrpc.rstatd(8)\fP, \fBinetd(8)\fP
.SH HISTORY
The \fBrup\fP command appeared in \fBSunOS\fP.
.SH BUGS
The sorting options are not implemented.
.SH AUTHOR
Adam Migus (amigus@cs.mun.ca)
